home *** CD-ROM | disk | FTP | other *** search
-
-
-
- ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd((((3333)))) ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd((((3333))))
-
-
-
- NNNNAAAAMMMMEEEE
- ttmedia_load - send a Display, Edit or Compose request
-
- SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
- ####iiiinnnncccclllluuuuddddeeee <<<<TTTTtttt////ttttttttttttkkkk....hhhh>>>>
- TTTTtttt____mmmmeeeessssssssaaaaggggeeee ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd((((TTTTtttt____mmmmeeeessssssssaaaaggggeeee _c_o_n_t_e_x_t,,,,
- TTTTttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd____mmmmssssgggg____ccccbbbb _c_b,,,,
- vvvvooooiiiidddd ****_c_l_i_e_n_t_d_a_t_a,,,,
- TTTTttttttttkkkk____oooopppp _o_p,,,,
- ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_m_e_d_i_a__t_y_p_e,,,,
- ccccoooonnnnsssstttt uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr ****_c_o_n_t_e_n_t_s,,,,
- iiiinnnntttt _l_e_n,,,,
- ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_f_i_l_e,,,,
- ccccoooonnnnsssstttt cccchhhhaaaarrrr ****_d_o_c_n_a_m_e,,,,
- iiiinnnntttt _s_e_n_d))));;;;
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- The ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd() function is used to create and optionally send a Media
- Exchange request to display, edit or compose a document.
-
- The _c_b argument will be passed _c_l_i_e_n_t_d_a_t_a when the reply is received, or
- when intermediate versions of the document are checkpointed through
- _D_e_p_o_s_i_t requests. The _o_p argument must be one of TTTTTTTTMMMMEEEE____DDDDIIIISSSSPPPPLLLLAAAAYYYY, TTTTTTTTMMMMEEEE____EEEEDDDDIIIITTTT
- or TTTTTTTTMMMMEEEE____CCCCOOOOMMMMPPPPOOOOSSSSEEEE. The _m_e_d_i_a__t_y_p_e argument names the data format of the
- document, and is usually the primary determinant of which application
- will be chosen to handle the request. The _c_o_n_t_e_n_t_s and _l_e_n arguments
- specify the document; if they are NNNNUUUULLLLLLLL and zero, respectively, and _f_i_l_e
- is not NNNNUUUULLLLLLLL, then the document is assumed to be contained in _f_i_l_e. If
- _d_o_c_n_a_m_e is not NNNNUUUULLLLLLLL, then ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd() uses it as the title of the
- document. If _s_e_n_d is True, the message is sent before being returned.
-
- The _c_o_n_t_e_x_t argument describes the environment to use. If _c_o_n_t_e_x_t is not
- zero, messages created by ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd() inherit from _c_o_n_t_e_x_t all
- contexts whose slotname begins with the characters EEEENNNNVVVV____.
-
- The TTTTttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd____mmmmssssgggg____ccccbbbb argument is a callback defined as:
-
- TTTTtttt____mmmmeeeessssssssaaaaggggeeee ((((****TTTTttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd____mmmmssssgggg____ccccbbbb))))((((TTTTtttt____mmmmeeeessssssssaaaaggggeeee _m_s_g,,,,
- vvvvooooiiiidddd ****_c_l_i_e_n_t_d_a_t_a)))),,,,
- TTTTttttttttkkkk____oooopppp _o_p,,,,
- uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr ****_c_o_n_t_e_n_t_s,,,,
- iiiinnnntttt _l_e_n,,,,
- cccchhhhaaaarrrr ****_f_i_l_e))));;;;
-
- The _m_s_g argument is the reply to the load request, or a _D_e_p_o_s_i_t request
- with a _m_e_s_s_a_g_e_I_D argument naming the identifier (see tttttttt____mmmmeeeessssssssaaaaggggeeee____iiiidddd(3)) of
- the load request. In the latter case, the client program becomes
- responsible for either failing or replying to the request. In either
- case, _m_s_g should be destroyed after being processed.
-
-
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd((((3333)))) ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd((((3333))))
-
-
-
- The _o_p argument is the op of _m_s_g. It must be either TTTTTTTTMMMMEEEE____DDDDEEEEPPPPOOOOSSSSIIIITTTT or the
- _o_p passed to ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd(3).
-
- The _c_o_n_t_e_n_t_s, _l_e_n and _f_i_l_e arguments represent the contents of the
- arriving document. If _l_e_n is zero, then the document is contained in
- _f_i_l_e. If _c_o_n_t_e_n_t_s or _f_i_l_e are non-NNNNUUUULLLLLLLL, they can be freed using
- tttttttt____ffffrrrreeeeeeee().
-
- The _c_l_i_e_n_t_d_a_t_a argument is the _c_l_i_e_n_t_d_a_t_a passed to ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd().
-
- RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
- Upon successful completion, the ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd() function returns the
- request it was asked to build; otherwise, it returns an error pointer.
- The application can use tttttttt____ppppttttrrrr____eeeerrrrrrrroooorrrr(3) to extract one of the following
- TTTTtttt____ssssttttaaaattttuuuussss values from the returned handle:
-
- TTTTTTTT____EEEERRRRRRRR____NNNNOOOOMMMMEEEEMMMM
- There is insufficient memory available to perform the
- function.
-
- TTTTTTTT____EEEERRRRRRRR____NNNNOOOOMMMMPPPP
- The ttttttttsssseeeessssssssiiiioooonnnn(1) process is not running and the ToolTalk
- service cannot restart it.
-
- TTTTTTTT____EEEERRRRRRRR____OOOOVVVVEEEERRRRFFFFLLLLOOOOWWWW
- The ToolTalk service has more active messages than it can
- handle. (The maximum number of active messages is
- implementation specific, but is at least 2000.)
-
- TTTTTTTT____EEEERRRRRRRR____PPPPRRRROOOOCCCCIIIIDDDD
- The specified process identifier is out of date or invalid.
-
- AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN UUUUSSSSAAAAGGGGEEEE
- After the request created by ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd() is sent, the application will
- probably want to use ttttttttddddtttt____ssssuuuubbbbccccoooonnnnttttrrrraaaacccctttt____mmmmaaaannnnaaaaggggeeee() immediately afterwards to
- manage the standard interactions with the handler of the request.
-
- A TTTTttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd____mmmmssssgggg____ccccbbbb callback should return NNNNUUUULLLLLLLL if it processes _m_s_g
- successfully, or a tttttttt____eeeerrrrrrrroooorrrr____ppppooooiiiinnnntttteeeerrrr() cast to TTTTtttt____mmmmeeeessssssssaaaaggggeeee if processing
- results in an error. It should return the _m_s_g if it does not consume it,
- in which case the ToolTalk service will pass TTTTTTTT____CCCCAAAALLLLLLLLBBBBAAAACCCCKKKK____CCCCOOOONNNNTTTTIIIINNNNUUUUEEEE down
- the call stack, so that _m_s_g will be offered to other callbacks or (more
- likely) be returned from tttttttt____mmmmeeeessssssssaaaaggggeeee____rrrreeeecccceeeeiiiivvvveeee(3). Applications will rarely
- want _m_s_g to get processed by other callbacks or in the main event loop.
-
- EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
- This is the typical algorithm of a TTTTttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd____mmmmssssgggg____ccccbbbb:
-
- TTTTtttt____mmmmeeeessssssssaaaaggggeeee
- mmmmyyyyLLLLooooaaaaddddMMMMssssggggCCCCBBBB((((TTTTtttt____mmmmeeeessssssssaaaaggggeeee mmmmssssgggg,,,,
- vvvvooooiiiidddd ****cccclllliiiieeeennnnttttDDDDaaaattttaaaa,,,,
- TTTTttttttttkkkk____oooopppp oooopppp,,,,
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-
-
-
- ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd((((3333)))) ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd((((3333))))
-
-
-
- uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr ****ccccoooonnnntttteeeennnnttttssss,,,,
- iiiinnnntttt lllleeeennnn,,,,
- cccchhhhaaaarrrr ****ffffiiiilllleeee))))
- {{{{
- iiiiffff ((((lllleeeennnn >>>> 0000)))) {{{{
- ////**** RRRReeeeppppllllaaaacccceeee ddddaaaattttaaaa wwwwiiiitttthhhh lllleeeennnn bbbbyyyytttteeeessss iiiinnnn ccccoooonnnntttteeeennnnttttssss ****////
- }}}} eeeellllsssseeee iiiiffff ((((ffffiiiilllleeee !!!!==== 0000)))) {{{{
- ////**** RRRReeeeppppllllaaaacccceeee ddddaaaattttaaaa wwwwiiiitttthhhh ddddaaaattttaaaa rrrreeeeaaaadddd ffffrrrroooommmm ffffiiiilllleeee ****////
- }}}}
- iiiiffff ((((oooopppp ======== TTTTTTTTMMMMEEEE____DDDDEEEEPPPPOOOOSSSSIIIITTTT)))) {{{{
- tttttttt____mmmmeeeessssssssaaaaggggeeee____rrrreeeeppppllllyyyy((((mmmmssssgggg))));;;;
- }}}}
- ttttttttttttkkkk____mmmmeeeessssssssaaaaggggeeee____ddddeeeessssttttrrrrooooyyyy((((mmmmssssgggg))));;;;
- rrrreeeettttuuuurrrrnnnn 0000;;;;
- }}}}
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- TTTTttttttttttttttttkkkk(5), ttttttttmmmmeeeeddddiiiiaaaa____llllooooaaaadddd____rrrreeeeppppllllyyyy(3), ttttttttmmmmeeeeddddiiiiaaaa____ppppttttyyyyppppeeee____ddddeeeeccccllllaaaarrrreeee(3),
- ttttttttmmmmeeeeddddiiiiaaaa____DDDDeeeeppppoooossssiiiitttt(3), tttttttt____ffffrrrreeeeeeee(3), tttttttt____mmmmeeeessssssssaaaaggggeeee____rrrreeeecccceeeeiiiivvvveeee(3).
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 3333
-
-
-
-